Product Specifications

Title Specifications

• Lowercase only
• Letters, numbers and underscores only (“_”)

Number values.

For values (e.g., length), the specification name is divided into at least three parts:

value_[unit]_[property].

value: literally the word “value”. This allows the system to understand that it is a value.

[unit]: the unit of the value.

For example, “cm” for centimeter.

[property]: the property to which the value applies.

For example, “length.”

When entering the value specification, pay attention to the following:

- - only numbers \- - no periods or commas

value_cm_length 125 Good

value_liter 7.2 Error

value_clit 720 Good

True/false choices

For true/false (yes/no) choices (e.g., free shipping), the specification name consists of at least two parts:

is_[property]

is: literally the word “is”. This allows the system to understand that the specification is a yes/no specification.

[property]: the value to which “true” or “false” applies.

For example, “free shipping.”

A true/false specification can be filled with:

true, yes, 1 or true: this property applies to the product.

false , no , 0 or true: this property does not apply to the product.

is_free shipping true

is_included_tetris false

Translatable Specifications

When a specification must be available for translation (for example, “color”), the specification name consists of at least two parts:

[iso code]_[name].

[iso code]: The ISO code of a country for which the translation applies is entered here. In this way, a translation can easily be displayed per sales channel. (look here for a list of all ISO codes).

For example “nl” for Dutch.

[name]: The name of the specification. Note that the name of the specification is the same for all translations.

For example “color”

A translatable specification is filled with the word that matches the language specified in the iso code.

nl color red

en color red

fr_color rouge

Dates

The specification name is not important when creating a date specification. However, the format of a date is important.

[YYYY]-[MM]-[DD]

[YYYY]: The year, written out in full

[MM]: The month, always in two digits.

For example, “03” for March

`[DD]`: The day, always in two digits.

For example, “08”

availability_from 2021-03-04

sale_until 2020-12-12

release date 2022-10-18

Other specifications

If a specification is not a value, is true/false choice or does not need to be translated then the format of the specification name does not need to be considered.

Examples are “brand” and “author”. After all, an author is called the same in Dutch as in German.

author Sjoerd Boddeus

character Gijs Riemersma

Through this link you will find a template file that you can use when preparing your product data and specifications.